home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / mkdir.z / mkdir
Encoding:
Text File  |  2002-10-03  |  5.9 KB  |  132 lines
  1.  
  2.  
  3.  
  4. mmmmkkkkddddiiiirrrr((((2222))))                                                              mmmmkkkkddddiiiirrrr((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mkdir - make a directory
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ssssttttaaaatttt....hhhh>>>>
  14.      iiiinnnntttt mmmmkkkkddddiiiirrrr ((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****ppppaaaatttthhhh,,,, mmmmooooddddeeee____tttt mmmmooooddddeeee))));;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _m_k_d_i_r creates a new directory with the name _p_a_t_h. The mode of the new
  18.      directory is initialized from _m_o_d_e (see _c_h_m_o_d(2) for values of _m_o_d_e].
  19.      The protection part of _m_o_d_e is modified by the process's mode mask (see
  20.      _u_m_a_s_k(2)).  The _SSSS______IIII_SSSS_GGGG_IIII_DDDD, _SSSS______IIII_SSSS_UUUU_IIII_DDDD, and _SSSS______IIII_SSSS_VVVV_TTTT_XXXX bits are silently deleted
  21.      from _m_o_d_e.
  22.  
  23.      The directory's owner ID is set to the process's effective user ID.  The
  24.      directory's group ID is set to the process's effective group ID or the
  25.      group ID of the directory in which the directory is being created.  This
  26.      is determined as follows:
  27.  
  28.      If the underlying filesystem was mounted with the BSD file creation
  29.      semantics flag (see _f_s_t_a_b(4)) or the SSSS____IIIISSSSGGGGIIIIDDDD bit is set (see _c_h_m_o_d(2)) on
  30.      the parent directory, then the group ID of the new  is set to the group
  31.      ID of the parent directory, otherwise it is set to the effective group ID
  32.      of the calling process.
  33.  
  34.      The newly created directory is empty with the possible exception of
  35.      entries for itself (.)  and its parent directory (..).
  36.  
  37.      Upon successful completion, _m_k_d_i_r marks for update the sssstttt____aaaattttiiiimmmmeeee, sssstttt____ccccttttiiiimmmmeeee
  38.      and sssstttt____mmmmttttiiiimmmmeeee fields of the directory.  Also, the sssstttt____ccccttttiiiimmmmeeee and sssstttt____mmmmttttiiiimmmmeeee
  39.      fields of the directory that contains the new entry are marked for
  40.      update.
  41.  
  42.      _m_k_d_i_r will fail and no directory will be created if one or more of the
  43.      following are true:
  44.  
  45.      [ENOTDIR]        A component of the path prefix is not a directory.
  46.  
  47.      [ENOENT]         A component of the path prefix does not exist.
  48.  
  49.      [ENAMETOOLONG]   The length of the _p_a_t_h argument exceeds {_P_A_T_H__M_A_X}, or a
  50.                       pathname component is longer than {_N_A_M_E__M_A_X}.
  51.  
  52.      [EACCES]         Either a component of the path prefix denies search
  53.                       permission or write permission is denied on the parent
  54.                       directory of the directory to be created.
  55.  
  56.      [EEXIST]         The named file already exists.
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. mmmmkkkkddddiiiirrrr((((2222))))                                                              mmmmkkkkddddiiiirrrr((((2222))))
  70.  
  71.  
  72.  
  73.      [EROFS]          The path prefix resides on a read-only filesystem.
  74.  
  75.      [EFAULT]         _P_a_t_h points outside the allocated address space of the
  76.                       process.
  77.  
  78.      [ELOOP]          Too many symbolic links were encountered in translating
  79.                       _p_a_t_h.
  80.  
  81.      [EMLINK]         The maximum number of links to the parent directory
  82.                       would exceed {_L_I_N_K__M_A_X}.
  83.  
  84.      [ENOSPC]         The directory in which the entry for the new directory
  85.                       is being placed cannot be extended because there is no
  86.                       space left on the filesystem containing the directory or
  87.                       the new directory cannot be created because there is no
  88.                       space left on the filesystem that will contain the
  89.                       directory or there are no free inodes on the filesystem
  90.                       on which the directory is being created.
  91.  
  92.      [EDQUOT]         The directory in which the entry for the new directory
  93.                       is being placed cannot be extended either because the
  94.                       user's quota of disk blocks on the filesystem containing
  95.                       the directory has been exhausted or the new directory
  96.                       cannot be created because the user's quota of disk
  97.                       blocks on the filesystem that will contain the directory
  98.                       has been exhausted or the user's quota of inodes on the
  99.                       filesystem on which the directory is being created has
  100.                       been exhausted.
  101.  
  102.      [EIO]            An I/O error has occurred while accessing the
  103.                       filesystem.
  104.  
  105. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  106.      mkdir(1), chmod(2), mknod(2), umask(2), unlink(2), fstab(4), stat(5)
  107.  
  108. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  109.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  110.      of -1 is returned, and _e_r_r_n_o is set to indicate the error.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.